package cn.tedu.tea.front.server.content.service;

import cn.tedu.tea.front.server.common.pojo.vo.PageData;
import cn.tedu.tea.front.server.common.security.CurrentPrincipal;
import cn.tedu.tea.front.server.content.pojo.param.CommentAddNewParam;
import cn.tedu.tea.front.server.content.pojo.vo.CommentListItemVO;
import org.springframework.transaction.annotation.Transactional;

/**
 * 处理评论数据的业务接口
 *
 * @author java@tedu.cn
 * @version 1.0
 */
@Transactional
public interface ICommentService {

    /**
     * 新增评论
     *
     * @param currentPrincipal   当事人
     * @param remoteAddr         IP地址
     * @param commentAddNewParam 新增的评论数据
     */
    void addNew(CurrentPrincipal currentPrincipal, String remoteAddr, CommentAddNewParam commentAddNewParam);

    /**
     * 根据文章查询评论列表，将使用默认的每页记录数
     *
     * @param articleId 文章的ID
     * @param pageNum   页码
     * @return 文章列表
     */
    PageData<CommentListItemVO> listByArticleId(Long articleId, Integer pageNum);

    /**
     * 根据文章查询评论列表
     *
     * @param articleId 文章的ID
     * @param pageNum   页码
     * @param pageSize  每页记录数
     * @return 文章列表
     */
    PageData<CommentListItemVO> listByArticleId(Long articleId, Integer pageNum, Integer pageSize);

}
